home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 40 / MACUSER-MACBIN40A-1997-03.ISO.7z / MACUSER-MACBIN40A-1997-03.ISO / オンラインソフト / オンラインソフト⁄毎号掲載 / 圧縮ソフト / MacBinary II+ 1.0.2 / MacBinary II+ Documentation < prev    next >
Text File  |  1993-05-05  |  5KB  |  90 lines

  1. MacBinary II+ v1.0.2 ゥ 1992-93 Peter Lewis.
  2. This program is free for any use.
  3.  
  4. ・ Contents
  5.  
  6.       What MacBinary II+ Does
  7.       What is MacBinary II+
  8.       Using MacBinary II+
  9.       Limitations
  10.       Small Print
  11.       Warranty
  12.       Fine Print
  13.       How It Works
  14.       Version History
  15.       Acknowledgements
  16.       The Author
  17.  
  18. ・ What MacBinary II+ Does
  19.  
  20. MacBinary II+ is a System 7 drag&drop converter for MacBinary files.  It has no User Interface, simply drop a MacBinary file on it and it will be decoded, drop any other file or folder on it and it will be encoded.
  21.  
  22. ・ What is MacBinary II+
  23.  
  24. MacBinary is a binary (non-text) format that encodes Macintosh files so that they can be safely stored or transfered through non-Macintosh systems.  MacBinary combines the two forks of a Mac file, together with the file information (Name, Creator Application, File Type, etc) into a single binary data stream, suitable for storage on non-Mac systems.  This serves a simmilar purpose to BinHex, except that BinHex takes things even further and stores the file using only text characters, so that the file will be preserved on almost any system, and can be sent through Email or USENET News without loss or corruption.
  25.  
  26. MacBinary II is the current standard for the MacBinary format.  I have further extended the format to allow the encoding of folder hierarchies into a single MacBinary II+ file.  But be warned, currently no one else implements this extension, and it may well be that no one else ever will, so the only program you can use to decode folders stored in MacBinary II+ format is this one.  Note that this does not affect files stored in MacBinary II format, since files use the MacBinary II format without the new extensions, so any MacBinary decoder should work happily.
  27.  
  28. ・ Using MacBinary II+
  29.  
  30. Simply drop a file onto MacBinary II+ and it will be decoded (if its a MacBinary file) or encoded (otherwise).
  31.  
  32. I will probably add the rest of the User Interface at some point, but for now, this should do for most System 7 users.
  33.  
  34. ・ Limitations
  35.  
  36. MacBinary II+ requires System 7, and probably requires the 128k ROM (or later).
  37.  
  38. ・ Small Print
  39.  
  40. This program is Free.  You can use it anywhere you want, you can do anything you like with it.  You can sell it if you let people know that they could get it for free from elsewhere.
  41.  
  42. ・ Warranty
  43.  
  44. There is absolutely NO warranty, guarantee, hint, suggestion or anything else that would lead anyone to think that MacBinary II+ do anything stated in this documentation.  It usually does not destroy data (systems, hardware, etc), and has sometimes worked on my Mac with System 7.0.  It will NOT work with older systems (pre 7.0) and probably not with the 64k ROM.  It might work with the other models, but I don't have them all, so I don't know.  It should work with or without any version of MacTCP.  If it works on your system (or especially if it doesnユt!), send me a postcard or some Email and let me know!
  45.  
  46. ・ Fine Print
  47.  
  48. Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose.  Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages.  In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim.  The person using the software bears all risk as to the quality and performance of the software.
  49.  
  50. ・ How It Works
  51.  
  52. MacBinary II+ listens for odoc AppleEvents, adds the files to a list.  It then goes thru and ecodes each file/folder into a MacBinary II+ file.  Encoding a file is fairly easy, it just requires creating a header block (see the MacBinary II specs) and then putting the data fork and then the resource fork after it.  Encoding a folder is not much more difficult, simply output a Start Block (see the MacBinary II+ sepcs), output each file/folder inside the folder, and then output an End Block.
  53.  
  54. ・ Version History
  55.  
  56. Still to do -
  57.  
  58. Simple UI for selecting files/folders (Apple, File, Edit menu etc)
  59.  
  60. 1.0.2
  61. ~Puts .bin.bin on the name
  62.  
  63. 1.0.1
  64. ~Doesn't recognize MacBinary 1 format files.
  65.  
  66. 1.0.0
  67.  
  68. ・ The Author
  69.  
  70. Other programs written by me:
  71. DeHQX 2.0.0 - BinHex decoder - superceeded by StuffIt Expander
  72. Finger 1.3.5 - Macintosh Finger client/daemon.
  73. Talk 1.0.6 - Macintosh Talk client/daemon.
  74. Chat 1.1.0 - Multiuser primitive irc-like daemon.
  75. FTPd 1.1.0 - Macintosh FTP server
  76. ObiWan 4.0.0 - Online help system
  77.  
  78. Send postcards, comments, bug reports, wishes to:
  79.  
  80. Peter Lewis,
  81. 10 Earlston Way,
  82. Booragoon, WA, 6154,
  83. AUSTRALIA
  84.  
  85. or by electronic mail to:
  86.  
  87. Internet: peter@cujo.curtin.edu.au
  88. Bitnet: peter%cujo.curtin.edu.au@cunyvm.bitnet
  89. UUCP: uunet!munnari.oz!cujo.curtin.edu.au!peter
  90.